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SELECT DISTINCT fragmentID, doctype, lastModif iedTime, title, creator, 
pagetype FROM raeta -metaall where KEYWORD LIKE »SERVER%' and PAGETYPE LIKE 
. ' FRAGMENT f and iscommit = 1 

An example DASL output to above query: 

<?xml version="l . 0" ?> 

<d:multistatus xmlns:d ="DAV:" xmlna : f -"Franklin: "> 
<f : responsesummary> 

<f : start>K/f :start> 

<f ;end>K/f :end> 

<f :total>K/f :total> 
</f: response sumraary>/ 
<d: response> 

<d:href>http://frar\klin'server/46b3e60dccbcd84db007777-tfrq xml 
</d:href> 

<d:pjcopstat> 

<d:prop> 

<f-FRAGMENTID>46b3e60dccbcd84db007777-tfrg.xml</f :FRAGMENTID> 
< f : DOCTYPE>TEXTFRAGM*NFT< ff : nnrTvuir-. 

^^T^H 20 ™ 'f : LASTMODIHEDTIME> 
<f :TITLE>Netfxnity Highlights</f ;TITLE> 

<f :CREATOR>Joe Doe< /f : CREATOR> 

<f : PAGETYPE>FRAGMENT</f : PAGETYPE> 
</d:prop> 

</d:propstat> 
</d:response> 
</d :iaultistatua> 

If the number of results is larger than the result set requested by the Search UI, the metadata 
store writes the full results into a cache file and only encodes the requested number into the 
DASL output. The cache file is named using an expression that encodes the query and the 
sessionld of the user. When the Search Ul requests the "Next" set of results for the same query 
the meta-data store does not re-execute the query. Instead it consults the cache file and extracts' 
the appropriate next set of results. This caching scheme saves the meta-data store from executing 
the same query several times if the user if simply navigating within the same result set. 

Note that if the contents where to change in DB2, the user does not see the updated results until 
he re-executes the original query without the "Next" or "Previous" flags. 

Lock Management 

When the dispatcher receives a lock command from the Editor UI, it creates a lock for a 
fragment or servable and sends the lock to the meta-data store to save in DB2. The lock 
information, namely locktokem, lockedowner, and locktime, is stored in the meta lock 
table of the following format: 

Column Name Data Type Default Key Index 

FRAMENTID CHAR (56) p K 

LOCKOWNER VARCHAR(50> 

LOCKTIME TIMESTAMP 

LOCKTOKEN VARCHAR(3<3; 
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When the dispatcher receives an unlock command from the Editor UT, it issues the unlock 
command to the meta-data store. The meta-data store deletes the record from the met a lock 
table. 

The Content Store - Daedalus (a.k.a Trigger Monitor) 

This section describes how the Franklin project has extended three of the Daedalus handlers to 
enable the system to manage XML fragments and XSL style sheets. For the full Daedalus API 
documentation, read http://w3.watsorLibmxom/^hallngr/papers/daedalus/index.html. 
Daedalus is written in pure Java and implements handlers as pre-defined actions performed on 
the various configurable resources. Flexibility is achieved via Java's dynamic loading abilities 
by more sophisticated configuration of the resources used by Daedalus, and through the use of 
handler preprocessing of input data. Most entities defined in a configuration file implement a 
public Java interface. Users may create their own classes to accomplish localized goals, and 
specify those classes in the configuration file. This permits run-time flexibility without requiring 
sophisticated efforts on the part of most users, since default classes are supplied to handle the 
most common situations. - 

For Franklin, we have created our own classes to implement three handlers: the Extension Parser 
the Dependency Parser, and the Page Assembler. 

Extension Parser 

Within Franklin, Daedalus manages different types of files differently based on their extensions. 
Servables, simple, compound, and index fragments, style sheets and multimedia assets are all 
treated slightly differently in the publishing flow. 

The Franklin Extension Parser takes in a name of a fragment, and returns an extension used in 
the Daedalus configuration files to specify actions to take during the publish process; 
123445-trfg.xnil => tfrg (text fragment) 
123445-bfrg.xral => bfrg (binary wrapper fragment) 
123445-ifrg.xml => ifrg (index fragment) 
123445-t3rv.xml => tsrv (text servable fragment) 
123445-afrg.xml => sfrg (style sheet wrapper fragment) 
web_index.xsl => xai (style sheet) 

The appropriate behavior for each type of fragment (e.g. source-to-sink, assemble-to-sink) is 
defined in the Daedalus configuration files. Generally, only servables are assembled to the sink. 

Dependency Parser 

The Franklin Dependency Parser reads through an XML objects that has been checked in and 
detects two types of dependencies: 

1 . Servables and fragments can include subfragments, these get stored as an edge of type 
"composition" in the Daedalus Object Dependency Graph (ODG). 

2. Compound fragments include an associated content file, this dependency gets stored as 
an edge type "composition" in the ODG. 

3. Servables can include style sheets, these get stored as an edge type "stylesheet" in the 
ODG. 
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Dependencies are considered to point from the subfragments to the fragments that include them 
For binary wrappers, one composition dependency points from the wrapper to the fragment that' 
includes it, and another points from the wrapper to the binary data file that it wraps. For 
stylesheets, a composition dependency points from the wrapper to the stylesheet, and a stylesheet 
dependency points from the stylesheet to the servabie that uses it. 

Page Assembler 

The Franklin Page Assembler expands a servabie by including the contents of all included 
subfragments, and combines the resulting XML with the one or more style sheets usine 
LotusXSL to produce HTML output files. The extension of each of the resulting files is 
determtned^orn the stylesheet names (e.g. web_xxxjitral.xsl). The assembled XML and all the 
suiting HTML flies are written to one file, which is later split up in the Dispatcher, and the 
1 ML h,es 3,16 written to the appropriate directories in the sink or server. 



Chaining of Trigger Monitors 

Currently, two Trigger Monitors are used in the publish process. They share an ODG and the 
sink of the first one is the source of the second, creating a publishing chain. The following 
diagram shows the set-up of the Content store in its entirety: 
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When a fragment is checked in to the Content store, it is added to the shared ODG and a publish 
command is issued to the first TM. The TM reads the fragment XML from the source servlet, 
uses the extension parser to find its extension, and then uses the dependency parser to find 
dependencies to add to the ODG. The page assembler then pulls in the contents of the 
fragment's subfragments, and if the fragment is a servable, combines it with its stylesheets to 
produce the output HTMLs. The servable XMLs, output HTMLs, binary files, and stylesheets 
are sent to the servlet specified as the sink of the first TM. 

When a servable has been approved, a publish command on the servable fragment is issued to 
the second TM. It is reassembled and recombined with its XSLs, and the resulting XML and 
HTMLs are published to the second sink servlet. Binary files (such as images) are also 
published to the second sink. This is where the web server pulls the final HTML and image files 
from. 

Example application 

- managing Netfinity pages at ibm.com 

Summary 

Appendix 1 : Error Codes 

# Status code (101) indicating the server is switching protocols 

# according to Upgrade header. (SC_SWITCHINGJ>ROTOCOLS) 

XI = 101 

# Status code (200) indicating the request succeeded normally. (SC_OK) 

G200 - 200 
P200 = 200 
OK = 200 

# Status code (201) indicating the request succeeded and created 

# a new resource on the server. (SC_CR£ATED) 

X3 = 201 

# Status code (202) indicating that a request was accepted for 

# processing, but was not completed. (SCACCEPTED) 

X4 = 202 

# Status code (203) indicating that the meta information presented 
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# by the client did not originate from the server. 
(SC_JNON_AUTHORITATTVE_JNFORM ATTON ) 

X5 = 203 

# Status code (204) indicating that the request succeeded but that 

# there was no new information to return. (SC_NO__CONTENT) 

X6 = 204 

# Status code (205) indicating that the agent <em>SHOULEK/em> reset 

# the document view which caused the request to be sent. (SC_RESET_CONTENT) 

X7 = 205 

# Status code (206) indicating that the server has fulfilled 

# the partial GET request for the resource. (SC_\P ARTIA LCONTENT) 

X8 = 206 

# Status code (300) indicating that the requested resource 

U corresponds to any one of a set of representations, each with 

# its own specific location. (SC_MULTJPLE_CHOICES) 

X9 = 300 

# Status code (301) indicating that the resource has permanently 

# moved to a new location, and that future references should use a 

# new URI with their requests. (SCJVIOVED PERMANENTLY) 

X10 = 30l 

# Status code (302) indicating that the resource has temporarily 

# moved to another location, but that future references should 

# still use the original URI to access the resource. (SC__MOVED TEMPORARILY) 

Xll = 302 

# Status code (303) indicating that the response to the request 

# can be found under a different URI. (SC_SEE_OTHER) 

X12-303 

# Status code (304) indicating that a conditional GET operation 

# found that the resource was available and not modified. (SC_NOT_MODlFIED) 
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X13 = 304 



# Status code (305) indicating that the requested resource 

# <em>MUST</em> be accessed through the proxy given by the 

# <code><em>Location</em></code> field. (SC_USE_PROXY) 



XI4 = 305 

# Status code (400) indicating the request sent by the client was 

# syntactically incorrect (SC_BAD_REQUEST) 

# THTS IS THE GENERAL (DEFAULT) ERROR RETURNED WHEN ANYTHING BREAKS 

#check c 102 to make sure it belongs in this area (400) 

CI 01 =400 

C102 = 400 

003 = 400 

C123 = 400 

C124 = 400 

D104- 400 

DUO = 400 

P101 =400 

V101=400 

F100 = 400 

F101=400 
F102 = 400 
F103=400 
F104 = 400 
F105-400 
R101 -400 
Rl 12 = 400 
R102-400 
R103 = 400 
R105 = 400 
D10I=400 
Dll I =400 
D145 = 400 
G103 = 400 

# Status code (401) indicating that the request requires HTTP 

# authentication. (SC_UNAUTHORIZED) 

G101 =401 
U101 =401 
UI02 - 401 
U1O3 = 401 



46 



PAGE 7/36 ' RCVD AT 4/14/2005 2:35:43 PM {Eastern Daylight Time] * 8VR:USPTO-EFXRF-1/2 " DNIS:8729306 * CSID:561 989 9812 * DURATION (mm-ss):1(W6 



04/14/2005 14:32 561-989-9812 FLEIT KAIN ET AL. PAGE 08/36 



L101=401 
L102 = 40l 
G104 - 401 

# Status code (402) reserved for future use. (SC_PAYMENT_REQUIRED) 
X17 = 402 

# Status code (403) indicating the server understood the request 

# but refused to fulfill it. (SC_FORBIDDEN) 

Gl02 = 4O3 
D123-403 

# Status code (404) indicating that the requested resource is not 

# available. (SCJNOT_FOUND) 

X19 = 404 

# Status code (405) indicating that the method specified in the 

# <code><em>Request-Line</em></code> is not allowed for the resource 

# identified by the <codexem>Request-URl</em></code> 
(SC_METHOD_NOT_ALLOWED) 

X20 = 405 

U Status code (406) indicating that the resource identified by the 

# request is only capable of generating response entities which have 

# content characteristics not acceptable according to the accept 

# headerssent in the request. (SC_NOT_ ACCEPTABLE) 

F108 = 406 

U Status code (407) indicating that the client <em>MUST</em> first 

# authenticate itself with the proxy. (SC_PROXY_AUTHENTICATION_REQUIRED) 

X22 = 407 

# Status code (408) indicating that the client did not produce a 

# requestwithin the time that the server was prepared to wait. (SC REQUEST TIMEOUT) 
X23 = 408 

# Status code (409) indicating that the request could not be 

# completed due to a conflict with the current state of the 

# resource. (SC_CONFLICT) 

X24 = 409 
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# Status code (410) indicating that the resource is no longer 

# available at the server and no forwarding address is known. 

# This condition <em>SHOULIX/em> be considered permanent. (SC_GONE) 

X25-410 

# Status code (411) indicating that the request cannot be handled 

# without a defined <code><em>Content-Length</em></code>. (SC_LENGTH_REQU1RED) 
X26 = 411 

# Status code (4 1 2) indicating that the precondition given in one 

# or more of the request-header fields evaluated to false when it 

# was tested on the server. (SCJ>RECONDITlON_FAILED) 

X27 = 412 

# Status code (413) indicating that the server is refusing to process 

# the request because the request entity is larger than the server is 

# willing or able to process. (SC_REQUEST_ENTITY_TOO_LARGE) 

X28 = 413 

# Status code (414) indicating that the server is refusing to service 

# the request because the <code><em>Request-URI</em></code> is longer 

# than the server is willing to interpret (SC J*EQUEST_URI_TOO_LONG) 

X29-414 

# Status code (415) indicating that the server is refusing to service 

# the request because the entity of the request is in a format not 

# supported by the requested resource for the requested method 
(SC_UNSUPPORTED_MEDIA_TYPE) 

X30 = 415 

# Status code (500) indicating an error inside the HTTP server 

# which prevented it from fulfilling the request (SC_INTERNAL_SERVER_ERROR) 
X31 -500 

# Status code (501) indicating the HTTP server does not support 

# the functionality needed to fulfill the request. (SCJNJOTJ MPLEMENTED) 

X32-501 
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# Status code (502) indicating that the HTTP server received an 

# invalid response from a server it consulted when acting as a 

# proxy or gateway. (SC_BAD_GATEWAY) 

X33 - 502 

# Status code (503) indicating that the HTTP server is 

# temporarily overloaded, and unable to handle the request (SC_SERVJCE_UNAVAILABLE) 
X34 - 503 

# Status code (504) indicating that the server did not receive 
U a timely response from the upstream server while acting as 

# a gateway or proxy. (SC GATEWAY T1MEOUT) 

X35 = 504 

# Status code (505) indicating that the server does not support 

U or refuses to support the HTTP protocol version that was used 

# in the request message. (SC_HTTP_VERSION_NOT_SUPPORTED) 

X36 = 505 

# Error code in server. dispatcher.Dispatcher 

# D104 = Error in Dispatcher.doPost() 

# Dl 10 = Fragment Type not Specified or incorrect 

# PI 01 = Error in Dispatcher.putParseRequestO 

# V 1 0 1 = Error val idating user 

U Error codes in server.Fragment 

# F100 ~ Error in Fragment. fragment2XML() 

# F101 - Error opening Fragment.XML2fragmentO 

# F102 = Error parsing XML file in FragmentXML2fragmentO 

# F103 - Error calling readNode("+element+") 

# F104 = Error calling getElement Value 

# Fl 05 = Error calling getElementType 

# F120 = Cannot close StringWriter 

# Error codes in server.TextUtils 

# RI01 = Error in TextFile.read( M +fIlename-i- M ) 

U Rl 12 = Error in TextFilc.readTextFi]eWOException( H +filename+") 

# R102 = Error in TextUtiIs.createDOMfromFile( ,! +xmlfile+ M ) 
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# R103 = TextUtils.createDomFromFile SAX exception 
U R105 - TextUtilsxreateDomFromFile lO exception 

# Rl 12 - Error in TextFile.readTextFiIeWOExceptio^(» , -^^^lename+ ,, ) 

# Error codes in server.dispatcher.DomUtils 

# D101 = DomUtils.documentToTuniverse TXDOM Exception 

# Dl 11= Error in DomUtils.documentToUniversal 

# DI23 = Missing or invalid sessionJD on checkin 

# Error codes in server.dispatcher. Users 

# these have destination ERROR JJSER 

# U101= User + username + not defined 

# U ! 02 = Wrong password for user + username 

# U1 03 = User with sessionid + sessionld + not defined 

# this has destination ERROR LOG 

# U1 10 = Users.methodname 10 exception 

# Error codes in server.dispatcher.checkTn 

# CI 03 = Error in document2String 

# Ci 02 = Checkin Error 

# C101 - Users.checJcProvIedge error 

# DE11 1 = Delete Error 

# G200 = successful get 

# P200 = successful put 

# Locking errors 

# L101 = Lock tokens do not match 

# LI 02 = missing lock token 

#MISC 

# F108 ^ invalid FragmentlD 

# C 1 23 = error in fragment2XML 

# C 124 - Failed saving content to metadata store 

# G104 =* Authorization String Empty 

# Dl 45 = error parsing input stream 
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